一个 macOS 状态栏小工具，用「电量百分比」的形式展示 Claude Code 与 Codex 的 usage 剩余额度，让你随时知道 5 小时窗口和每周额度还剩多少。

它既不登录你的账号，也不爬网页，而是“偷听”Claude Code 和 Codex 在你电脑本地留下的“聊天记录”，从中算出还剩多少额度。

功能

• 状态栏常驻显示主工具的 5h 剩余百分比，低于阈值时变色提醒
• 点击展开弹窗，对比查看 Claude Code / Codex 的 5h 与 weekly 剩余额度、重置时间
• 支持 Claude Code 与 Codex 双数据源，自动定时刷新（默认 30s，可调 1/3/5 分钟）
• 一键 setup Claude Code：自动注入 statusLine hook 抓取 usage，原有 statusLine 命令会保留并继续执行
• 开机启动、刷新频率、提醒/警告阈值、显示模式等可在设置页配置
• 中英双语本地化

安装方式

• 下载发布版：到 Releases 下载最新 .dmg，拖进 Applications 即可（未签名/公证，首次启动若被拦截，在“系统设置 → 隐私与安全性”点“仍要打开”）。
• 源码构建：macOS 14.0+，建议当前 Xcode；克隆后执行 ./script/build_and_run.sh或直接用 Xcode 打开 agent-battery.xcodeproj运行。
• 初次使用时：
• Claude Code​ 需要点一下 Settings → Claude Code 设置 → Setup，完成后在任意目录运行一次 claude触发 statusLine，即可看到额度。
• Codex​ 用户一般无需 setup，只要本地有 ~/.codex/sessions/下的会话文件，应用可直接读取。